home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / utildos2.arc / RE-VIEW.DOC < prev    next >
Text File  |  1984-11-16  |  11KB  |  230 lines
  1.          ----------------------------------------
  2.         |      *** RE-VIEW  1.8 ***         |
  3.         |                     |
  4.         |  Copyright (C) 1983 by Vincent T. Bly  |
  5.         |                     |
  6.         |   RE-VIEW is a user supported program. |
  7.         | If you use RE-VIEW, send $15 to:     |
  8.         |         Vincent Bly         |
  9.         |         P. O. Box 409         |
  10.         |         Ft. Belvoir, VA  22060     |
  11.         |                     |
  12.         |   You are encouraged to give copies of |
  13.         | this software and documentation to your|
  14.         | friends.  Please make sure it includes |
  15.         | the notice above.  Anyone who wishes to|
  16.         | get RE-VIEW directly from the author     |
  17.         | can send $22 which covers the software,|
  18.         | diskette, mailer, and postage.     |
  19.         |                     |
  20.         |   Support will be provided to users who|
  21.         | have paid for the program.  Send your  |
  22.         | clearly worded questions to the above  |
  23.         | address.  A stamped, self-addressed     |
  24.         | envelope will speed replies.         |
  25.          ----------------------------------------
  26.  
  27.  
  28.    GENERAL DESCRIPTION
  29.    -------------------
  30.        RE-VIEW provides enhanced text display capabilities for the IBM PC
  31.    or PC-XT equipped with the standard Color/Graphics Adapter.    It is also
  32.    compatible with the COMPAQ portable computer.  RE-VIEW can be used with
  33.    MS-DOS 1.0, 1.1, or 2.0.  Its main features include:
  34.        a) A 75 line screen buffer which saves text as it scrolls off the
  35.    top of the active display page.
  36.        b) The ability to review the 75 line screen buffer and the active
  37.    display page together as one virtual screen of 100 text lines.
  38.        c) The ability to scroll rapidly up and down the 100 line virtual
  39.    screen, a line at a time or a page (25 lines) at a time.
  40.        d) The ability to quickly pause normal screen display by tapping
  41.    the [Scroll Lock] key.  During the pause, you can review any text in
  42.    the 100 line virtual screen.
  43.        e) The ability to temporarily stop saving new scrolled text, so
  44.    that text already in the buffer is preserved for future reference.
  45.        f) An improved scrolling routine with substantually reduced flicker.
  46.  
  47.  
  48.    PAGING KEYS
  49.    -----------
  50.        RE-VIEW uses the extreme right-hand [-] and [+] keys for page up and
  51.    page down functions, respectively (the normal [-] and [+] keys are not
  52.    affected).  These keys are used by RE-VIEW to avoid incompatibility with
  53.    other programs which use the [Pg Up] and [Pg Dn] keys for their own
  54.    purposes.
  55.        In the text below, "rgt[-]" and "rgt[+]" signify the extreme right-
  56.    hand [-] and [+] keys, respectively.  "<shft>rgt[-]" and "<shft>rgt[+]"
  57.    signify the shifted right-hand [-] and [+] keys.
  58.  
  59.  
  60.    LIMITATIONS
  61.    -----------
  62.        RE-VIEW only operates with the Color/Graphics Adapter.  It is NOT
  63.    compatible with the Monochrome Display Adapter.  RE-VIEW's main features
  64.    operate in the 80 column text mode only (although the quick pause feature
  65.    can be used from any display mode).    Also, the DOS 2.0 ANSI.SYS device
  66.    driver is not compatible with RE-VIEW; however, a patching program is
  67.    provided with RE-VIEW which will create a compatible version of ANSI.SYS.
  68.  
  69.  
  70.    INSTALLING RE-VIEW
  71.    ------------------
  72.        RE-VIEW can be installed from DOS by typing the command: RE-VIEW
  73.    and pressing return.  Normally, you would include this command in your
  74.    AUTOEXEC.BAT file.  Once RE-VIEW has been installed, it will remain in
  75.    your system--ready to provide the capabilities listed below--until you
  76.    turn your system off or reboot with <Ctrl><Alt>[Del].
  77.  
  78.  
  79.    USING RE-VIEW
  80.    -------------
  81.        RE-VIEWs features can be used any time your computer is waiting for
  82.    keyboard input.  The function of the keys used by RE-VIEW are as follows:
  83.  
  84.    rgt[-] or rgt[+] ... These keys allow you to quickly scroll up or down
  85.             through the 100 line virtual screen, a line at a time.
  86.  
  87.    <shft>rgt[-] or <shft>rgt[+] ... These keys allow you to move up or down
  88.             through the 100 line virtual screen, a page at a time
  89.             (there are a total of 4 pages).
  90.  
  91.    <Alt>[Scroll Lock] ... This key combination allows you to toggle saving of
  92.             scrolled text into the 75 line buffer.    In order to
  93.             help you keep track of the current state--an audible
  94.             signal will be sounded as follows:
  95.                    2 BEEPS - scrolled text will be saved,
  96.                    1 BEEP  - scrolled text will not be saved.
  97.                This feature can be used to save text created by
  98.             one program for later review by another.  For example,
  99.             you could use TYPE to display up to 75 lines of your
  100.             program source code.  Next, you would scroll the lines
  101.             off the screen to save them in the 75 line buffer.*
  102.             Next, you would press <Alt>[Scroll Lock] to prevent
  103.             future scrolled lines from disturbing the contents of
  104.             the buffer.  Now, you could enter DEBUG to analyze
  105.             your program, while--at any time--being able to review
  106.             your commented source code using RE-VIEW's paging keys
  107.             (rgt[-], etc.).
  108.             *  The UP.COM program, included with RE-VIEW, makes
  109.             scrolling the text into the buffer easier--see the
  110.             description near the end of this documentation.
  111.  
  112.        RE-VIEW's features can also be used while your computer is displaying
  113.    text on the screen.    First--you must pause the screen display by pressing
  114.    the [Scroll Lock] key.  During the pause you may use the keys listed below:
  115.  
  116.    rgt[-] or rgt[+] ... Scroll up or down through the 100 line virtual
  117.             screen, a line at a time.
  118.  
  119.    <shft>rgt[-] or <shft>rgt[+] ... Move through the (4 page) virtual screen,
  120.             a page at a time.
  121.  
  122.    <Alt>[Scroll Lock] ... Toggle between saving and not saving scrolled text.
  123.  
  124.    <Ctrl>[Scroll Lock] = "Break" ... Perform a Break immediately.  Unlike the
  125.             <Ctrl>[Num Lock] pause, the [Scroll Lock] pause does
  126.             not throw away the key used to restart.  Therefore you
  127.             do not need to hit the "Break" key twice.
  128.  
  129.    Any Other Key (including [Scroll Lock]) ... Restart normal screen display.
  130.  
  131.  
  132.    COMPATIBLE PROGRAMS
  133.    -------------------
  134.        RE-VIEW is compatible with most text producing programs which print
  135.    to the screen using the standard DOS or ROM routines.  Known compatible
  136.    programs include:
  137.            DIR, TYPE, <MORE, TREE, COMP, DEBUG, EDLIN, and BASIC.
  138.  
  139.  
  140.    DEACTIVATING RE-VIEW
  141.    --------------------
  142.        Some programs will not be compatible with RE-VIEW.  These include:
  143.             a) programs which access screen memory directly;
  144.             b) programs which use screen pages other than page 0;
  145.             c) and, programs which use the same keys as RE-VIEW.
  146.    When you use one of these programs or need to use the right-hand [-] and
  147.    [+] keys for data entry, you can--temporarily--deactivate RE-VIEW by
  148.    pressing <Ctrl><Alt>[Scroll Lock].  When deactivated, RE-VIEW will have
  149.    no effect on system processing except for a small routine which will wait
  150.    for the next press of <Ctrl><Alt>[Scroll Lock], which you can use to
  151.    reactivate RE-VIEW.    NOTE: you should use this feature from DOS, not from
  152.    an application program (for example, you can deactivate RE-VIEW from BASIC,
  153.    but must return to DOS to reactivate it).
  154.  
  155.  
  156.    USING RE-VIEW WITH BASIC
  157.    ------------------------
  158.        RE-VIEW's features can be very helpful in BASIC, especially when list-
  159.    ing long programs.  It is also compatible with SofTool Systems' BASIC
  160.    Development System (BDS).  However, you should be aware that many BASIC
  161.    programs will destroy the contents of RE-VIEW's screen buffer when they
  162.    are run.  Most WIDTH and SCREEN commands will clear the buffer, some other
  163.    commands may also.  However, this does not affect RE-VIEW's assistance in
  164.    reviewing listing of large BASIC programs or the output of utilities such
  165.    as SofTool's BDS.
  166.  
  167.  
  168.    AUXILIARY PROGRAMS
  169.    -------------------
  170.        Three auxiliary programs are included with RE-VIEW:
  171.         CLA.COM ....... This program provides the DOS command CLA, which
  172.                 operates like DOS 2.0's CLS command, except that
  173.                 all 100 lines of the virtual screen are cleared.
  174.         UP.EXE ........ This program provides the DOS command UP, which
  175.                 scrolls the text above the cursor just off the
  176.                 top of the screen into the 75 line save buffer.
  177.                 (Use it with <Alt>[Scroll Lock] to save text pro-
  178.                 duced by one program for later review by another.)
  179.         ANSIPCH.EXE ... This program patches DOS 2.0's ANSI.SYS program
  180.                 to provide compatibility with RE-VIEW (see below).
  181.  
  182.  
  183.    USING RE-VIEW WITH ANSI.SYS
  184.    ---------------------------
  185.        If you are using the DOS 2.0 ANSI.SYS device driver, you will need to
  186.    patch it for compatibility with RE-VIEW.  The original ANSI.SYS does not
  187.    use the standard ROM routines for scrolling.  Therefore, RE-VIEW will be
  188.    ineffective on systems using the original ANSI.SYS driver.  The program,
  189.    ANSIPCH.EXE, creates a patched version of ANSI.SYS which is compatible
  190.    with RE-VIEW and provides all the features of the original ANSI.SYS.
  191.        You can patch ANSI.SYS as follows:
  192.         1 ... Make sure the disk you are using has a copy of the
  193.               files "ANSI.SYS" and "ANSIPCH.EXE".
  194.         2 ... Type ANSIPCH and press return.  In a few seconds, you
  195.               should see the message -
  196.               "*** Patch complete. Patched version = ANSIR.SYS ***".
  197.         3 ... Edit your CONFIG.SYS file, changing the line -
  198.               "DEVICE = ANSI.SYS" to
  199.               "DEVICE = ANSIR.SYS".
  200.         4 ... Re-boot your system to install the patched version of
  201.               ANSI.SYS.  Now install RE-VIEW by typing RE-VIEW and
  202.               pressing return; everything should work properly now.
  203.         Note: ANSIPCH.EXE presumes the original version of ANSI.SYS
  204.               (dated 03/08/83) is on the default disk drive.  If it
  205.               is not found, ANSIPCH will abort after displaying the
  206.               message -
  207.               "* Cannot open ANSI.SYS *".
  208.               If ANSI.SYS is found, but does not compare with the
  209.               original version, ANSIPCH will abort after displaying
  210.               the message -
  211.               "* Unfamiliar version of ANSI.SYS, patching aborted. *"
  212.  
  213.  
  214.    CREDITS
  215.    -------
  216.        IBM is a registered trademark of International Business Machines Corp.
  217.        COMPAQ is a trademark of COMPAQ Computer Corporation.
  218.        BASIC Development System (BDS), copyright (C) SofTool Systems 1982.
  219.  
  220.  
  221.  
  222.         This disk copy was originally provided by "The Public Library",
  223.         the software library of the Houston Area League of PC Users.
  224.  
  225.         Programs are available from the Public Library at $2 per disk
  226.         on user-provided disks.  To get a listing of the disks in the
  227.         Public Library, send a self-addressed, stamped envelope to
  228.  
  229.              Nelson Ford,  P.O.Box 61565,  Houston, TX 77208.
  230.